Facility Navigation Bar Tool – Configuring the Drop-Down Levels

Note: You can change configuration settings for this tool in Run mode. However, these settings usually only persist for the current runtime session. When you close the CygNet Studio screen on which the tool resides, the tool settings may revert to those originally configured in Edit mode. To learn how to override this behavior, see RuntimeCfgAutoPersist.

You use the Levels property to define the number of drop-down levels in the Facility Navigation Bar Tool and to describe the behavior of each level. "Levels" are the drop-down menus that filter facilities.

Typically, each level shows a different aspect of the facility selected in the leftmost (level 0) drop-down. You can create multiple levels to filter and search facilities based on different facility attributes.

This topic includes the following sections:

To Configure Drop-Down Levels

Configure the General properties of the Facility Navigation Bar Tool, as described in Configuring the Facility Navigation Bar Tool, then click on the Levels tab to display the following dialog box:

Facility Navigation Bar Tool - General tab

With the Levels chooser, select the total number of drop-down levels you want the tool to include.

With the Level menu, select a drop-down level to configure.

With the Filter menu, select the attribute that the level will use to filter the facilities.

If you selected a table-driven attribute with the Filter menu, use the Show Descriptions check box to specify whether you want the level to show descriptions instead of table entry names.

Select Attribute or Text to describe the Label that will appear over the level in Run mode, provided that Labels > Visible is selected on the General page:

Attribute: Sets the label to the Attribute name that appears in the dimmed Text field.
Text: Sets the label to the text you specify in the Text field.

Use Variable and Fixed to define the width of the drop-down level:

Variable: Specifies that the drop-down is scalable in Edit mode. Levels are scaled in relation to each other unless you specify a width for one or more of them using the Fixed option.
Fixed: Sets the drop-down width to a value that you specify. Enter the drop-down width (in pixels) in the field. The default is 100 pixels. To hide a level, select Fixed and enter 0 (zero) in the field.

When you finish defining this level, click Apply to save your settings. Then select another drop-down level to configure with the Level menu and perform steps 2 to 8 for this level. Continue until you have configured all levels.

Click OK to save your level settings. Open the tool in Run mode to verify that it is working as expected.

Level Properties

The following table describes the level properties:

Property	Description
Level	Specifies the drop-down level to which the properties apply.
Levels	Specifies the total number of drop-down levels in the tool. The default is 3.
Filter	Defines the attribute that must be assigned to a facility for it to be included in the level. Default is Facility Desc.
Show Descriptions	Specifies whether descriptions (rather than table entry names) are shown for table-driven facility attributes. This check box appears only if you select a table-driven attribute with the Filter menu.
Label	Defines a label for the drop-down level. If you select Attribute, the description of the attribute (as displayed in the dimmed Text field) is used as a label. Attribute is the default. If you select Text, the text you enter in the field is used as the label.
Width	Specifies the width (in pixels) of the drop-down level. Select Variable if you want the width to be automatically configured and the levels to be scaled in relation to each other. Variable is the default. Select Fixed if you want to specify a width for the drop-down, and enter that width (in pixels) in the field. To hide a level, select Fixed and enter a width of 0.

Property

Description

Level

Specifies the drop-down level to which the properties apply.

Levels

Specifies the total number of drop-down levels in the tool. The default is 3.

Filter

Defines the attribute that must be assigned to a facility for it to be included in the level. Default is Facility Desc.

Show Descriptions

Specifies whether descriptions (rather than table entry names) are shown for table-driven facility attributes. This check box appears only if you select a table-driven attribute with the Filter menu.

Label

Defines a label for the drop-down level.

If you select Attribute, the description of the attribute (as displayed in the dimmed Text field) is used as a label. Attribute is the default.
If you select Text, the text you enter in the field is used as the label.

Width

Specifies the width (in pixels) of the drop-down level.

Select Variable if you want the width to be automatically configured and the levels to be scaled in relation to each other. Variable is the default.
Select Fixed if you want to specify a width for the drop-down, and enter that width (in pixels) in the field. To hide a level, select Fixed and enter a width of 0.